Purpose

This pull request introduces support for multiple authentication contexts ("multi-auth context") in the Asgardeo React SDK by adding an instanceId parameter throughout the authentication client and provider. This enables applications to manage multiple independent authentication sessions within the same app instance. The most important changes are grouped below:

Multi-auth context support:

• Added an optional instanceId property to the AsgardeoReactConfig interface to allow configuration of multiple authentication contexts.
• Updated the AsgardeoReactClient class to accept an instanceId in its constructor, store it, and provide a getInstanceId() method. The AuthAPI is now initialized with the instanceId as well.
• Modified the AuthAPI class to accept and store an instanceId, pass it to the underlying SPA client, and expose a getInstanceId() method. [1] [2]
• Updated the AsgardeoProvider React component to accept an optional instanceId prop (defaulting to 0), and to instantiate the AsgardeoReactClient with this value, ensuring correct context isolation.

Related Issues

• feat: Support multiple Asgardeo Provider instances via optional instanceID #311

Related PRs

• N/A

Checklist

• Followed the CONTRIBUTING guidelines.
• Manual test round performed and verified.
• Documentation provided. (Add links if there are any)
• Unit tests provided. (Add links if there are any)

Security checks

• Followed secure coding standards in http://wso2.com/technical-reports/wso2-secure-engineering-guidelines?
• Confirmed that this PR doesn't commit any keys, passwords, tokens, usernames, or other secrets?